home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / ACORNET / OLD-VERSIONS / ANET013A / !Acornet / Apps / !ArcWeb / Instruct < prev    next >
Text File  |  1995-12-11  |  8KB  |  173 lines
  1. Instructions for configuring Network & EMail options
  2. ====================================================
  3.  
  4. There are currently 3 sections to the Network configuration window:
  5. Fetchers, Proxies, Miscellaneous.  There are 3 sections in the
  6. EMail & News window: User details, E-Mail Gateways, News server
  7.  
  8. Note that any changes are not effected until you click on OK, and
  9. they are NOT saved unless you click on Save Options.
  10.  
  11. Fetchers
  12. ========
  13.  
  14. This box contains 4 entries, HTTP FTP WAIS Gopher, the WAIS entry greyed 
  15. out. These indicate whether ArcWeb will respond to URLs starting http: ftp:
  16. wais: gopher: respectively.  If you do not have them selected, then you will
  17. most likely get a 'No fetcher for ...' error whenever you try to access
  18. anything non-local.
  19.  
  20. So leave the HTTP box switched on always, and probably leave the FTP one
  21. switched on, unless you find that you are having trouble with ftp: URLs
  22. crashing the machine.  Also leave the gopher one switch on.
  23.  
  24. The reason why the WAIS option is greyed out and unselectable is because
  25. ArcWeb doesn't (yet!) know how to do that itself.  It needs a proxy server
  26. to do it for it, which is explained in the next section...
  27.  
  28.  
  29. Proxies
  30. =======
  31.  
  32. This section contains 4 proxy definitions, and 1 'No proxy' definition.
  33. Read the file WotIsProxy which was in the root of the ArcWeb archive.
  34. Follow the instructions at the bottom of that file in order to read
  35. the HTML version of my definition of a proxy.
  36.  
  37. Each line in this section of the window represents a different URL scheme
  38. (HTTP, FTP, Gopher and WAIS).  The large middle box contains the name of the
  39. proxy server, and the small box contains the TCP port number on which the
  40. proxy service is provided.  The proxy is only used if the checkbox for that
  41. scheme is switched on.  You probably want to leave all 4 of these switched
  42. on.  If you are a Demon subscriber, then you want to ensure that all four
  43. host/port pairs are set to www-cache.demon.co.uk and 8080 ; UK academic
  44. community users want wwwcache.hensa.ac.uk in all the host boxes, and 8080 in
  45. the HTTP, FTP and Gopher ports, and 80 in the WAIS port.
  46.  
  47. Whenever a request is issued, ArcWeb looks first at the proxy configuration
  48. to see if the proxy for that URL scheme is configured and enabled (* except
  49. see the No Proxy section below).  If it is not, then it looks at the state of
  50. the 'Fetchers' section.  If the scheme is not enabled in there either, then
  51. ArcWeb ignores the request and you will get a 'No fetcher for ...' error. 
  52. But if the 'Fetchers' section does mark the scheme as enabled, then ArcWeb
  53. will communicate directly with the host who's name is given in the URL.
  54.  
  55. If the proxy *is* enabled for the scheme, then ArcWeb talks to the configured
  56. proxy server for that scheme in preference to making a direct connection.
  57.  
  58. (*) The 'No proxy' box is used to avoid proxying requests to 'nearby'
  59. machines (in network terms, not necessarily geographical distances). 
  60. Usually, if the scheme is enabled in *both* the 'Proxies' section and the
  61. 'Fetchers' section of the window, then the proxy will 'win' and be used in
  62. preference to the direct connection method.  However, if the host name used
  63. in the URL matches the No Proxy entry, then the proxy will not win, and a
  64. direct connection will be attempted.
  65.  
  66. ArcWeb will compare the *end* bit of the hostname with the contents of the
  67. no proxy box in order to match the entries.  So for example, if I set the no
  68. proxy to "ac.uk" and I ask for "http://www.ecs.soton.ac.uk/" then this is
  69. classified as a match, because the hostname ends "ac.uk".  If I ask for
  70. "http://www.demon.co.uk/" then this does not match.  Similarly, if I ask for
  71. "http://lilac.ukansas.edu/" (I don't know if this exists or not - it is only
  72. an example) then this does *NOT* match, despite the ac.uk in the middle.
  73.  
  74. You can have a comma seperated list of match domains in the no proxy box,
  75. eg. ac.uk,acorn.co.uk which will cause addresses to be compared with
  76. "ac.uk" and then with "acorn.co.uk".  An address has to not match any of
  77. these entries in order to be proxied.
  78.  
  79.  
  80. Miscellaneous
  81. =============
  82.  
  83. There are 2 options in this section regarding the actions that ArcWeb
  84. should take at particular points of its execution.
  85.  
  86. If the 'Retain authentication' option is *OFF* (as recommended), then the
  87. cache of user name/passwords used during the current session will be DELETED
  88. as a security precaution.  If the option in *ON*, then the data is retained
  89. in the cache permanently (until you switch the option off and quit ArcWeb, or
  90. manually delete the !WebCache.Data.Auth_DB file).  If you are the only user
  91. of your machine and it is relatively physically secure, then there is no harm
  92. of switching on this option.  For example, you can access the Clan Acorn
  93. pages (if you are a member) and once you have entered the password then that
  94. will be remembered in future sessions.
  95.  
  96. If the 'Ask for confirmation when using unofficial ports' is switched *ON*
  97. (as recommended), then any attempt to use a particular scheme on a different
  98. port from its well-known port will be intercepted and you will be prompted to
  99. confirm the fetch. For example, the gopher protocol runs on TCP port 70.  If
  100. you find a URL such as "gopher://some.host.name:79/0hello" then this will be
  101. trapped, since port 79 is not the standard gopher port (it is the 'finger'
  102. port actually) and you will be asked to confirm that the connection should
  103. go ahead.  The result of continuing this fetch (in this example) will be to
  104. actually perform the equivalent of 'finger hello@some.host.name' and won't
  105. have anything to do with gopher at all.  The results of talking to a server
  106. using the wrong protocol are at best undefined.
  107.  
  108. NOTE: since many people who run http servers (under UNIX) do not have 'root'
  109. user access, they cannot run the server on the well-known port for http
  110. (which is 80).  This is the reason you see http servers run on port 8080,
  111. 8001 and others.  For this reason, http URLs are *never* trapped in this
  112. manner by ArcWeb.
  113.  
  114.  
  115.  
  116. EMail & News Configuration
  117. ==========================
  118.  
  119. This section contains the information which ArcWeb requires in order to
  120. service mailto: URLs and some news: or nntp: URLs.   Note that this will NOT
  121. download your mail or news from your provider as it is not a 'transport' for
  122. any other application you might have.  The gateways section will disappear as
  123. soon as suitable support is built into other applications.
  124.  
  125. User Details
  126. ============
  127.  
  128. You should enter you full name in the Name box, and your complete e-mail
  129. address in the Address box.  This will enable services which are provided
  130. by submitting forms via e-mail to respond to you!  They are also used if
  131. you send e-mail with ArcWeb.
  132.  
  133. E-Mail gateways
  134. ===============
  135.  
  136. You should enable the second option "Smarthost mail gateway", and enter
  137. the hostname of your smart host mail gateway.  This is the machine which
  138. will accept any mail FROM you to anyone else.  eg. Demon users can use
  139. post.demon.co.uk as a smarthost.
  140.  
  141. MX mail delivery isn't implemented currently, hence it is greyed out.
  142. This will usually be more efficient (the message will get to its
  143. destination quicker), but may take longer to send if the MX host is
  144. a long way away.
  145.  
  146. If you follow a 'mailto:' URL link, then ArcWeb will create a small text file
  147. and open it in your current text file editor.   Once you have completed the
  148. e-mail, you should 'Save' the document *directly* from the editor onto
  149. ArcWeb's icon bar icon, and it will then be sent.  This is a *kludgy* way of
  150. sending mail and much better support will be provided in the future by proper
  151. e-mail programs.  What You See in the editor is What Is Sent to the mail
  152. server, so don't mess around with the headers except to change the subject
  153. line.  In particular, don't move the To: line because ArcWeb relies on
  154. finding it there.  There is *no* concept of adding taglines, signatures or
  155. anything.
  156.  
  157. News Server
  158. ===========
  159.  
  160. The 'News Server' big box contains the name of a news server which is willing
  161. to talk to you. If you have the News Server icon switched on, then ArcWeb
  162. will attempt to retrieve specific articles from the given server.  Note that
  163. this is, again, a *kludge* so that specific articles can be read.  It does
  164. *NOT* provide any kind of menu of articles, threading etc. (yet!)
  165.  
  166.  
  167.  
  168. --
  169. Stewart Brodie
  170. 11th December 1995
  171.  
  172. ==END==
  173.